EventsCli

Section: Misc. Reference Manual Pages (8N)
Index Return to Main Contents
EventsCli - Command Line Interface for sending alarms to Pep, SNMP, etc  

SYNOPSIS

EventsCli -h host -n name -v measured_value -u units -q quiet -s severity -t trap_num -T threshold -S state

 

DESCRIPTION

EventsCli is a user interface to the Events alarm dispatching facilities. It can be used to send SNMP traps, notify Pep, and log an event. These events can be from external processes that call EventsCli each time a condition warrents reporting.

The EventsCli is intended to be an interface between your existing system monitoring programs and scripts. These programs and scripts can call EventsCli and then rely upon the SNMP traps, Events data logging, and Pep to take the corrective action you desire.

 

OPTIONS

-h host
The hostname the trap references
-u units
The units value specifys the unit of measure for the value measured.
-q quiet
EventsCli will not prompt user for confirmation of data.
-v measured_value
The value being reported. This can be any data type including a short string.
-n name
A brief name, which must be quoted if it contains white space, could be a test name, or other descriptive text.
-s severity
Where severity is a number between a low of 1 and a high of 5.
-t trap_num
Events has twelve general purpose TRAPs for EventsCli. These are numbered from 500 to 511. The trap_num you choose can be arbitrary but must be within the range indicated.
-T threshold
The name of the threshold exceeded. This is a very short description of what happened i.e. "low alarm threshold". In real life, any brief text is acceptable.
-S state
For setting the state of the trap, ie. "low", "hi", and "ok"

 

EXAMPLE

EventsCli -n DatabaseA -T "high tps" -u "tps" -v 12345 -s 5 -t 501

This might mean: (-c) DatabaseA is doing (-v) 12345 (-u) tps and has exceeded the (-T) high tps threshold. The event will be reported with the highest severity level (-s) 5 and will be sent using trap number (-t) 501

 

RESTRICTIONS

EventsCli must be invoked on a machine that has AgentMon running.


 

Index

SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
RESTRICTIONS

This document was created by man2html, using the manual pages.
Time: 21:02:08 GMT, November 08, 2022